Snapshot Sourcesafe Tool - Version 1.0, 09 April 1998

Snapshot is a tool for generating changed files in a Sourcesafe database. Sourcesafe doesn't provide an easy mechanism for detecting what has changed between two dates in the database. This is exactly what you need when you are changing your software, and don't want to be so methodically that you write down every file you change all the time.

Requirements

Snapshot is tested on Windows NT 4.0, but should also work on Windows95/98.
Snapshot is written in Visual C++ 5.0, and uses the runtime for Visual 5.0. The runtime files needed are installed by the installation program.
Snapshot also requires that Sourcesafe 5.0 is installed with its Automation Interface. This interface is used by Snapshot to extract the needed information.

Disclaimer and License Agreement

The author cannot be held responsible for any loss of data or any other damage incurred as a result of using this program.
Snapshot is freeware and comes with no warranty.
All distributions of Snapshot must include all files contained in the archive it was originally packaged in.
Any questions regarding distribution should be directed to Bj°rn Sundby at bjsundby@online.no.

Usage

The next topics contain a short description of the usage of Snapshot.

Overview

Snapshot uses snapshots for comparing versions of files. A snapshot is a definition of a source and target sourcesafe project together with specification for which time the comparison shall be based. The following options are available:

A snapshot is defined and saved in a file with the "ssh" extension in the snapshot directory. This snapshot can then be created. This will create a file with the extension "ssf" where all found files with path and version number are stored. This created snapshot can then be compared as specified, and the difference between the two are displayed in the changed files window.

You normally compare the same project between a previous label or date, and the latest version to obtain the difference. If you share complete project trees to create and maintain releases, then you can compare two different project trees against each other and get the difference.

Main Window

Snapshot is a SDI application looking like a dialog application. The main window is shown below.

The database field shows the currently open sourcesafe database.

The snapshot area contains a list of the defined and created snapshots.

The Changed files area contains a report of the last snapshot compare operation.

Menu

The "File" menu contain the following commands:

The "Edit" menu contain the following commands:

The "Snapshot" menu contain the following commands:

Open Database Dialog

This dialog is used to browse for and select the Sourcesafe Database that should be used. It works more or less like the dialog found in Sourcesafe.

Browse Snapshot Location Dialog

This is a standard directory browse dialog for selection where the snapshot files should be saved.

Snapshot Dialog

This dialog is used for defining and editing a snapshot.

Select Sourcesafe Project dialog

This dialog is used to select a project tree in Sourcesafe where you want to compare files.

Select Label Dialog

This dialog is used to select a existing label for the version of your files.

Select Date Dialog

This dialog is used to select a date for the version of your files.

Bugs and Enhancement Reporting

If you find any bugs,  has some ideas for enhancement, or just want to tell me how great this tool is then send me an e-mail at bjsundby@online.no.

I may fix the bug, implement the enhancement or not depending on the time I have available for this kind of projects.

For the latest version and other information, the go to the Snapshot Home Page.

B.Sundby